.. _`Rename datasource with Regex`:

.. _`org.sysess.sympathy.datasources.rename`:

Rename datasource with Regex
````````````````````````````

.. image:: datasource_rename.svg
   :width: 48


Applies a regular expression to modify the PATH of a datasource.




Documentation
:::::::::::::

Create Datasource by modifying the PATH of a Datasource with a regular
expression (regex). For more information about how to write regex, see
:ref:`appendix_regex`.


Definition
::::::::::


Input ports
...........

    **input**  datasource
        Datasource input


Output ports
............

    **output**  datasource
        Datasource output




Configuration
.............

    **Replace** (replace)
        Text to replace the matched parts with. Use eg. ``\1`` to substitute the first matched (parenthesis) group.
    **Search** (search)
        Part of path to replace using a regular expression. Use "$" for end of name and "^" for the beginning. Learn more about Regular expression syntax in the documentation appendix.







Examples
........

* :download:`FileOperations.syx </Examples/Sympathy/Disk/File/FileOperations.syx>`




Implementation
..............

.. automodule:: node_rename
    :noindex:

.. class:: RenameDatasource
    :noindex: